v2026.5.5: : Inactive upgrades, Windows bash and bunx fixes

Compare Source

A grab-bag release: a new --inactive flag for catching installed-but-unconfigured tools, several Windows fixes around bunx and the bash task shell, and correctness fixes for the npm shim, aqua bin-path resolution, and dotnet prereleases.

Added

• (outdated/upgrade) New --inactive flag on mise outdated and mise upgrade that includes installed-but-inactive tools — versions you have installed but that aren't referenced by the current config (#​9640) by @​roele. Useful for cleaning up or upgrading old tool installs:

  # show every installed tool that has a newer version, even if it's not in mise.toml
  mise outdated --inactive
  
  # upgrade an installed-but-inactive tool to its current latest
  mise upgrade tiny --inactive

  When a tool has no config source, --inactive resolves against the backend's latest version rather than the pinned installed version.

Fixed

• (node) The generated npm shim now invokes <this-install>/bin/node directly instead of node from PATH. Previously, running one Node install's npm while a different Node version was active could let npm derive its global prefix from the other install, sending default packages to the wrong place (#​9749) by @​jdx.

• (bun, Windows) mise install bun on Windows now creates a bunx entry alongside bun.exe, matching what the upstream PowerShell installer does. mise tries a bunx.exe -> bun.exe hardlink first (bun switches to bunx mode based on argv[0]) and falls back to a bunx.cmd shim. reshim picks it up automatically, so bunx <pkg> finally works under mise-managed bun on Windows (#​9732) by @​JamBalaya56562.

• (task, Windows) When a task uses shell = "bash -c" and mise is invoked from PowerShell, C:\Windows\System32\bash.exe (the WSL launcher) used to win the PATH search, silently running the task body inside a WSL Linux user-space where mise-managed Windows tools aren't visible. mise now resolves bash in this order: MISE_BASH_PATH, common Git Bash install locations (C:\Program Files\Git\bin\bash.exe, the x86 variant, %LOCALAPPDATA%\Programs\Git\bin\bash.exe), the existing PATH search, and finally an explicit reject of the WSL launcher with a warning (#​9750) by @​JamBalaya56562. sh/zsh/fish/ksh/dash and non-Windows builds are unaffected.

• (aqua) Aqua list_bin_paths() correctly handles packages whose actual git tags add an extra v after a version prefix (e.g. tool-v1.2.3 for canonical 1.2.3), without putting remote resolution back on the bin-path hot path that was reverted in #​5574. Install passes the already-resolved tag/version directly into file-link creation instead of recomputing it (#​9759) by @​risu729.

• (dotnet) The dotnet backend now uses the shared prerelease = true tool option used by aqua/github, fetches the NuGet prerelease superset, and skips the latest fast paths when prereleases are enabled. The global prereleases setting and the deprecated dotnet.package_flags = ["prerelease"] continue to work (#​9720) by @​risu729:

  MISE_EXPERIMENTAL=1 mise ls-remote 'dotnet:GitVersion.Tool[prerelease=true]'

Registry

• Added scalafmt (github:scalameta/scalafmt) — the official Scala formatter (#​9757) by @​pokir.
• Removed flarectl: upstream cloudflare/cloudflare-go no longer ships release binaries (the existing registry test was already commented out) (#​9756) by @​risu729.
• Removed 49 registry shorthands with zero recorded users (bbr, brig, btrace, carp, clarinet, cli53, concourse, conduit, copper, credhub, datree, djinni, dome, draft, dtm, envcli, esy, glen, grain, inlets, kcctl, ki, kp, krab, kube-credential-cache, kubefedctl, kubefirst, kubemqctl, kwt, lab, lane, levant, melt, opsgenie-lamp, pachctl, psc-package, purerl, redo, rke, sinker, soracom, starboard, sver, terradozer, titan, uaa-cli, wasm4, wren-cli, zbctl) (#​9725) by @​jdx. Tools added in 2026 were skipped, and any of these can still be installed with explicit backend syntax (e.g. mise use aqua:cloudfoundry/uaa-cli).

Documentation

• (secrets) Document that direct age encryption requires experimental mode, that age decryption is strict by default, and that age.strict=false skips undecryptable values and keeps resolving the environment (#​9737) by @​risu729.
• (tasks) Add a bash shebang to the conditional-dependencies example (#​9747) by @​JamBalaya56562.
• Backend tool option docs: document S3 support for size, strip_components, bin, and rename_exe; add no_app to GitLab and Forgejo; clarify that GitHub-family api_url covers release lookup and private/self-hosted API downloads, not just version listing (#​9738) by @​risu729.

New Contributors

• @​pokir made their first contribution in #​9757

Full Changelog: jdx/mise@v2026.5.4...v2026.5.5

💚 Sponsor mise

mise is built by @​jdx under en.dev — an independent studio making developer tooling (mise, aube, and more). Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at en.dev. Individual and company sponsorships keep mise fast, free, and independent.

v2026.5.4: : Java on Alpine, faster pwsh exits

Compare Source

A small release that smooths out Java installs on Alpine, makes pwsh shell activation noticeably snappier, and cleans up ibmcloud's $PATH footprint.

Added

• (java) Automatic musl detection on Alpine Linux (#​9688) by @​roele. Java versions on Alpine no longer require an explicit -musl feature suffix — mise-java now exposes an alpine-linux OS containing the musl builds, and mise selects it automatically when running on a musl libc. So this:

  mise use java@corretto-25

  picks the Alpine/musl Corretto build on Alpine, and -musl-suffixed versions (e.g. corretto-musl-25) continue to resolve for backwards compatibility.

Fixed

• (registry) ibmcloud now uses symlink_bins, so only the ibmcloud binary is placed on $PATH instead of the entire install directory. This prevents the bundled install binary from shadowing /usr/bin/install (#​9685) by @​dnwe.

Performance

• (pwsh) Activation no longer spawns a fresh pwsh -NoProfile -Command exit $status (or powershell on PS 5) after every hook just to propagate mise's exit code — it now assigns $global:LASTEXITCODE = $status directly. On a typical machine that's ~270ms (pwsh) or ~185ms (powershell) shaved off every prompt (#​9723) by @​vemoo.

Changed

• (schema) xtasks/render/schema.ts no longer overwrites $defs.task_template and the trailing $defs.task.oneOf branch on every mise run render:schema; those shapes already live in schema/mise.json, with lightweight guard checks remaining (#​9680) by @​risu729.

Aqua Registry Updates

New packages:

• DataDog/managed-kubernetes-auditing-toolkit
• oracle.com/sqlcl

Updated packages:

• alltuner/mise-completions-sync
• iann0036/iamlive
• pnpm/pnpm

Full Changelog: jdx/mise@v2026.5.3...v2026.5.4

💚 Sponsor mise

mise is built by @​jdx under en.dev — an independent studio making developer tooling (mise, aube, and more). Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at en.dev. Individual and company sponsorships keep mise fast, free, and independent.

v2026.5.3: : Aqua latest from GitHub releases

Compare Source

A small patch release that fixes how the aqua backend resolves latest for tools backed by GitHub releases.

Fixed

• (aqua) Resolve latest via GitHub's latest-release endpoint instead of walking the chronological tag list, so mise use <tool>@&#8203;latest and similar requests pick the upstream "latest" release rather than the newest tag. Packages using version_source = github_tag continue to use the existing tag-based fallback, and before_date / minimum_release_age settings still bypass the fast path. Tag-to-version normalization (version prefixes, leading v, asset checks) is now shared across remote listing, install lookup, and latest resolution (#​9277) by @​risu729.

Full Changelog: jdx/mise@v2026.5.2...v2026.5.3

💚 Sponsor mise

mise is built by @​jdx under en.dev — an independent studio making developer tooling (mise, aube, and more). Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at en.dev. Individual and company sponsorships keep mise fast, free, and independent.

v2026.5.2: : Stable monorepo task roots, fail-fast parallel tasks, and curated lockfiles

Compare Source

Added

• (aqua) Support registry libc variants (gnu vs musl) when resolving package overrides on Linux, including cross-platform lock targets like linux-x64-musl (#​9652) by @​jdx.
• (aqua) Honor aqua registry files[].link and files[].hard entries, creating relative symlink (or hard link) aliases next to extracted binaries so tools that inspect $0/argv[0] (e.g. granted/assumego, newer pnpm) launch correctly (#​9610) by @​risu729.
• (bin-paths) New mise bin-paths --bin-names flag prints executable names from active bin directories, and --json now emits structured entries with name, path, and symlink (#​9617) by @​risu729.
• (task) Added MISE_MONOREPO_ROOT env var pointing at the directory of the config with experimental_monorepo_root = true (#​9657) by @​jdx.
• (registry) Added code-review-graph via pipx:code-review-graph (#​9673) by @​chautruonglong.

Fixed

• (task) Parallel mise run --jobs N siblings now terminate promptly when one task fails, via per-task process groups and killpg, with a 10s pipe-drain timeout (#​9655) by @​jdx.
• (task) MISE_PROJECT_ROOT for monorepo subproject tasks is now stable regardless of invocation cwd (#​9657) by @​jdx.
• (install) Don't force a remote-versions cache refresh in prefer_offline mode; fixes a v2026.5.0 regression with shim auto-install of prefix: requests (#​9627) by @​jdx.
• (lockfile) Auto-lock during mise install now respects user-curated lockfiles — removed platforms stay removed (#​9621) by @​jdx.
• (lock) mise lock from a nested project scopes targets to the active project root and stops churning parent lockfiles; --global is now exclusive (#​9319) by @​risu729.
• (deps) Fall through to source-hash freshness when a provider returns no outputs, so bundle install, pip install, go mod download, poetry install, and uv sync stop rerunning on every invocation (#​9622) by @​jdx.
• (backend) Inline tool option overrides (e.g. tool[asset_pattern=...]) are now applied consistently across all backends, with backend alias [...] options as a distinct overlay layer (#​9306) by @​risu729.
• (backend) Skip the mise-versions host when locally overridden tool options affect remote version listing (#​9568) by @​risu729.
• (backend) Reject bare package-backend names like cargo and gem as implicit cargo:cargo/gem:gem tools (#​9608) by @​risu729.
• (aqua) Preserve configured file extensions (e.g. .bat scripts) on Windows; avoid doubling version_prefix (#​9611) by @​risu729.
• (github) Chmod only the explicitly configured bin target instead of every archive file (#​9609) by @​risu729.
• (pipx) Filter yanked PyPI releases from fuzzy/latest resolution while keeping exact pinned installs available (#​9607) by @​risu729.
• (pipx) Declare python as a backend dependency so pipx.pyz resolves to mise-managed Python (#​9678) by @​jdx.
• (trust) Run enter hooks after mise trust newly trusts a config for the current directory (#​9634) by @​risu729.
• (ui) Stop clearing the screen for confirmation prompts like mise prune (#​9619) by @​jdx.
• Use /bin/cp on macOS for mise sync so it doesn't break when GNU cp from Homebrew shadows it on PATH (#​9656) by @​pdehlke.
• (schema) Update refs to $defs in mise-registry-tool.json (#​9671) by @​risu729.

Changed

• (registry) Removed registry-level depends from generated registry tools and added test.tools for tools whose dependencies are only needed by mise test-tool (#​9571) by @​risu729.
• (config) Registry backend options now accept full TOML values (booleans, integers, arrays, tables) instead of strings only (#​9584) by @​risu729.

Documentation

• (node) Added tips for enabling node idiomatic version files (#​9675) by @​fu050409.

New Contributors

• @​chautruonglong made their first contribution in #​9673
• @​pdehlke made their first contribution in #​9656

💚 Sponsor mise

mise is built by @​jdx under en.dev — an independent studio making developer tooling (mise, aube, and more). Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at en.dev. Individual and company sponsorships keep mise fast, free, and independent.

v2026.5.1: : Aqua cosign and a reshim rescue

Compare Source

A small follow-up to v2026.5.0 that lands top-level cosign verification for the aqua backend, fixes a mise reshim failure caused by stale latest install directories, and tightens schema validation.

Added

• (backend) The aqua backend now honors top-level cosign metadata when verifying packages, covering both checksum and artifact flows and reusing the existing native sigstore path. Lockfiles record top-level cosign provenance, with new e2e and lockfile regression coverage (#​9111) by @​risu729.
• (registry) Added wasm-tools via aqua:bytecodealliance/wasm-tools for working with the WebAssembly Component Model (#​9596) by @​2xdevv.

Fixed

• (shim) mise reshim no longer aborts with failed to rebuild shims: no versions found for <tool> when an install directory literally named latest (or any other non-resolvable name) is left on disk. Toolset::list_installed_versions already reads concrete version directory names, so it now constructs ToolVersion directly instead of calling .resolve() (no network), and per-tool ToolRequest::new failures are warned-and-skipped instead of aborting the entire rebuild (#​9599) by @​jdx. Repro:

  mkdir -p ~/.mise/installs/buck2/latest/bin
  touch ~/.mise/installs/buck2/latest/bin/buck2
  mise reshim   # previously failed; now succeeds

• (schema) All files under schema/ are now validated against draft/2020-12 in strict mode. Hand-written schemas and the BoolOrString renderer in schema.ts use oneOf instead of union type arrays so AJV's strictTypes no longer rejects them; the bogus --strict-schema flag is replaced with --strict-types=true --strict-tuples=true (#​9594) by @​risu729.

• (registry) elixir-ls re-enables symlink_bins so the move to the aqua backend stops exposing internal binaries that aren't meant to be called directly (#​9592) by @​AlternateRT.

Changed

• (registry) rebar now installs from the GitHub backend (erlang/rebar3) since rebar3 is just an escript; the asdf plugin fallback is removed. Versions before rebar 3 are no longer supported, and the installed executable remains rebar3 to match upstream docs (#​9576) by @​risu729.
• (registry) bashly drops the asdf:mise-plugins/mise-bashly fallback and the redundant explicit ruby dependency, since the gem backend already pulls in Ruby (#​9578) by @​risu729.
• (release) Restored the "Sponsor mise" block on every successful GitHub release. It had been accidentally scoped to the communique-failure fallback in #​9395, so normal releases since v2026.4.22 lost it (#​9580) by @​jdx.

Documentation

• (dev-tools) Clarified that vfox metadata depends runs install hooks for the listed dependency tools (#​9573) by @​risu729.
• (plugins) Removed outdated registry submission guidance from the plugins docs (#​9577) by @​risu729.

Aqua Registry Updates

New packages:

• salesforce/reactive-grpc/protoc-gen-reactor-grpc
• spinframework/spin

Updated:

• pnpm/pnpm

Full Changelog: jdx/mise@v2026.5.0...v2026.5.1

💚 Sponsor mise

mise is built by @​jdx under en.dev — an independent studio making developer tooling (mise, aube, and more). Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at en.dev. Individual and company sponsorships keep mise fast, free, and independent.